home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / com_and1.zip / README.DOC < prev    next >
Text File  |  1990-10-16  |  20KB  |  441 lines
  1. -------------------------------------------------------------------------------
  2. 901016                COM-AND 2.7                Page  1
  3. -------------------------------------------------------------------------------
  4. This release of COM-AND:
  5. -------------------------------------------------------------------------------
  6.  
  7.      o    This is the eigth release of COM-AND (version 2.7).  This release
  8.     corrects problems reported with version 2.6 and adds features.
  9.  
  10.      o    Run instructions and installation procedures will be found following
  11.     this page.
  12.  
  13.      o    Changes to the previous version (additions and corrections) are to
  14.     be found following run/installation pages.
  15.  
  16.      o    The author asks for comments and criticisms of this program.
  17.     You may contact the author:
  18.  
  19.     CABER Software            PLINK, GEnie id: TARTAN
  20.     R. (Scott) McGinnis        UNISON id: SCOTTM
  21.     P.O. Box 3607 Mdse Mart
  22.     Chicago, IL 60654-0607
  23.  
  24. -------------------------------------------------------------------------------
  25. Release history (not including beta releases)
  26. -------------------------------------------------------------------------------
  27.    860806: PC-VCO 1.0
  28.    860929: PC-VCO 1.1
  29.    861119: PC-VCO 1.2
  30.    861222: PC-VCO 1.3
  31.    861226: PC-VCO 1.31
  32.    870814: PC-VCO 2.0     COM-AND 2.0   CCHESS 1.0
  33.    871202: PC-VCO 2.1     COM-AND 2.1   CCHESS 1.1
  34.    871211:                         CBRIDG 1.0
  35.    880122:                              CCOLOR 1.0
  36.    880713: PC-VCO 2.2     COM-AND 2.2   CCHESS 1.2    CBRIDG 1.1   CCOLOR 1.1
  37.    881202:         COM-AND 2.3
  38.    890309:         COM-AND 2.4
  39.    891020:         COM-AND 2.5
  40.    900426:         COM-AND 2.6
  41.    901019:         COM-AND 2.7   CACMP 1.0     (You are here)
  42. -------------------------------------------------------------------------------
  43.  
  44. -------------------------------------------------------------------------------
  45. 901016                COM-AND 2.7                Page  2
  46. -------------------------------------------------------------------------------
  47. Files in this distribution:
  48. -------------------------------------------------------------------------------
  49.  
  50.      CA26-1.ARC:
  51.  
  52.     COM-AND.EXE    2.7  executable
  53.     COM-AND.PIF    PIF file for Windows
  54.     COM-AND.DVP    DVP file for DesqView
  55.     COM-AND.ICO    WIndows 3.0 ICON file (Dr. David Snyder thank you!)
  56.     README.DOC    This file.
  57.     REGISTER.DOC    Registration form
  58.  
  59.      CA26-2.ARC:
  60.  
  61.     COM-AND.DOC    Documentation for version 2.7 manual functions
  62.     CASCRIPT.DOC    Documentation for version 2.7 script language
  63.     README.DOC    This file.
  64.     REGISTER.DOC    Registration form
  65.  
  66.      CA26-3.ARC:
  67.  
  68.     SCRIPTS.DOC    Summary documentation for scripts
  69.     REGISTER.DOC    Registration form
  70.     README.DOC    This file.
  71.     *.CMD/*.DOC    REMAP.CMD, XLATE.CMD, LEARN.CMD, FILEMGR.CMD...
  72.  
  73.      CA26-4.ARC:
  74.  
  75.     CACMP.EXE    COM-AND script syntax/semantic check
  76.     CACMP.DOC    Documentation for CACMP.EXE
  77.     OVERLAY.*    Sample script overlay files
  78.     TALKER.*    Sample script overlay supprting limited speech synth
  79.     VOICE.*     Voice driver and documentation for TALKER
  80.     VEND.COM    Voice driver termination utility
  81.     PC-VCO.EXC    Excpetion file for TALKER.CMD script
  82.     README.DOC    This file.
  83.     REGISTER.DOC    Registration form
  84.  
  85. -------------------------------------------------------------------------------
  86.    *    COM-AND creates any files it requires that it does not find on the
  87.     drive:subdirectory where it is loaded (or on the drive:subdirectory
  88.     where the environment variable COM-AND= directs the processor)
  89. -------------------------------------------------------------------------------
  90.    *    To print the document files, deARC the file onto disc and use the DOS
  91.     command "PRINT <file>.DOC".  COM-AND documents are formatted 54 lines
  92.     to the page, with top-of-forms as page breaks, using tab characters.
  93. -------------------------------------------------------------------------------
  94.  
  95. -------------------------------------------------------------------------------
  96. 901016                COM-AND 2.7                Page  3
  97. -------------------------------------------------------------------------------
  98. Notice:  Two changes in this version of COM-AND require attention:
  99. -------------------------------------------------------------------------------
  100.  
  101.  
  102.    *    This version of COM-AND changes the self-encrypted script function of
  103.     COM-AND.  During the development of 2.6, it was found that a compiler
  104.     bug in MASM 5.0 (used to develop the ENCRYPTION in COM-AND) yielded an
  105.     unintended password for self-encrypted scripts.
  106.  
  107.     Version 2.6 was developed with MASM 5.1, and thus the bug appeared.
  108.     When the ENCRYPTION code of version 2.5 was re-compiled, scripts en-
  109.     crypted (for passwordless decryption) were left unusable.
  110.  
  111.     For version 2.6, the developer simply re-compiled the ENCRYPTION code
  112.     of COM-AND with MASM 5.0, allowing scripts self-encrypted with pre-
  113.     vious versions of COM-AND to continue to execute.  However...
  114.  
  115.     That mistake has been made again.  The only sure correction is to bite
  116.     the bullet, invalidate current self-encrypted scripts, and ask that
  117.     self-encrypted scripts simply be re-encrypted.
  118.  
  119.     Please re-encrypt any self-encrypted scripts used, from the original.
  120.     Scripts self-encrypted with version 2.6 will not work under 2.7.
  121.  
  122. -------------------------------------------------------------------------------
  123.  
  124.  
  125.    *    This version adds a feature that may startle some and bore most, but
  126.     provide a base for simplifying installation of COM-AND.  If COM-AND
  127.     is loaded on a subdirectory where no COM-AND.DFT resides AND if the
  128.     environment variable COM-AND= does not point to a subdirectory where
  129.     COM-AND.DFT may be found, COM-AND will create a new .DFT file.
  130.  
  131.     A new script named INSTALL.CMD is included with this release.  If
  132.     COM-AND creates its .DFT file (as opposed to updating an existing
  133.     one), and if the script INSTALL.CMD is available, INSTALL will be
  134.     invoked automatically upon completion of initialization.
  135.  
  136.     The INSTALL.CMD script included with this release is a move towards
  137.     simplification of installation, especially where the individual does
  138.     not have years of experience with modems and comm programs.  It is
  139.     hoped that the script included with this release will grow over time,
  140.     with suggestions and comments.
  141.  
  142.     INSTALL may be manually invoked through the F2 window, of course.
  143.     However, it is suggested that you delete INSTALL.CMD after use, to
  144.     salvage precious disk space.
  145.  
  146.  
  147. -------------------------------------------------------------------------------
  148. 901016                  COM-AND 2.7                Page  4
  149. -------------------------------------------------------------------------------
  150. Run instructions:
  151. -------------------------------------------------------------------------------
  152.  
  153. o    To run COM-AND from the DOS prompt:
  154.        (Install the release as described below)
  155.  
  156.        C> COM-AND
  157.  
  158.        (Run this way, the F1 menu makes many accessories available to
  159.        you.  You can modify (and create) new accessories with the 'r'
  160.        subcommand at any time.)
  161.  
  162. -------------------------------------------------------------------------------
  163. Installation:
  164. -------------------------------------------------------------------------------
  165.  
  166. 1)    Set your current subdirectory to the subdirectory where you wish
  167.     to install COM-AND... where you've already installed previous
  168.     COM-ANDs (if you've used one).  I'd suggest "\COM-AND".
  169.  
  170. 2)    DeARC the distribution file.  Have a care not to overwrite files
  171.     you want to keep!
  172.  
  173. 3)    Load COM-AND (i.e. C> COM-AND <return>).  If this is the first time,
  174.     follow the prompts provided by INSTALL.CMD (automatically invoked).
  175.     After INSTALL (if INSTALL was automatic) and otherwise:
  176.  
  177.     o  Check Alt-S
  178.        .. Modem parms are set for HAYES - you may want to change them.
  179.        .. The backscreen buffer size defaults to 4K.  You can set it
  180.           up to 64K, for redisplay and transcripting.
  181.        .. Remember to save the new settings.
  182.     o  Check Alt-P
  183.        .. Choose the COM port you use (1/2/3/4).
  184.        .. Default speed selection is not usually important (if you always
  185.           use the dialing directory).  Set it anyway.
  186.        .. Remember to save new settings.
  187.     o  Check Alt-O
  188.        .. Set flags the way you want them (e.g. exit query on, d*mned
  189.           advert off, and so on;  Note BIOS/DIRECT and PCJr settings)
  190.        .. Remember to save new settings.
  191.  
  192. 4)    Review the accessories (F1).
  193.  
  194.        You may review the contents of accessory definitions with the 'r'
  195.        subcommand.    You may wish to add entries for a listing program
  196.        and editor.. and perhaps PC-VCO... CCOLOR...
  197.  
  198. 5)    Exit COM-AND with Alt-X.
  199.  
  200.  
  201. -------------------------------------------------------------------------------
  202. 901016                  COM-AND 2.7                Page  5
  203. -------------------------------------------------------------------------------
  204. Additions and corrections this release:
  205. -------------------------------------------------------------------------------
  206.  
  207.     ---------------------------------------
  208.     Changes and corrections to 2.6 COM-AND:
  209.     ---------------------------------------
  210.  
  211. o    Reduced run-time memory requirement by 1K (over loaded memory req'm't)
  212. o    Removed 1.x script code (about 1K)
  213. o    Corrected highlight on Alt-P Base/IRQ subwindow to fit field
  214. o    Changed RTS usage in COMM.ASM... 1) Raise RTS unless RTSD (even if
  215.     RTSF), and 2) don't lower after write unless HARD ON.  This allows
  216.     bidirectional modems to work out-of-box without RTSF
  217. o    Changed Alt-H hangup to Drop DTR (if set) AND issue hangup
  218. o    Put a max time on wait for ACK/NAK after ZNAK received (in ZMODEM)
  219.     and packet retransmitted (60 secs).
  220. o    Corrected ZMODEM (and all batch protocols) to accept a file name
  221.     such as 90.12345 (truncating ext to 3 chars)
  222. o    Changed ZMODEM send-side to cancel after 10 NAKs.
  223. o    Changed ZMODEM to suppress immediate 'auto-ZMODEM' startup after a
  224.     questionable transfer (triggered by other side's INIT).
  225. o    All transfers - if we are XOFFED when receive read times-out, reset
  226.     the timer and continue trying (Telenet prob)
  227. o    "Carrier dropped" calllog time change to report time since last call
  228.     (was reporting time since pgm loaded)
  229. o    Allow tabs in run command (batch execution)
  230. o    Refined XON/XOFF handling code (for duplicate XOFFs)
  231. o    Corrected up-arrow handling in Alt-M
  232. o    Corrected undesirable interaction between remapping and menu mode
  233. o    Corrected status line after Alt-255 '.' command changes it (LEGEND)
  234. o    Corrected loops and skips in Alt-B backscreen when TOF and ANSI CLS
  235. o    Corrected all select-type windows to replace invalid alpha entry w/#
  236. o    Changed F2 window to use menu defaults by popular demand
  237. o    Cosmetic changes to screen clock
  238. o    Changed F5 (ASCII send) to always return to 'go' after selections
  239.  
  240.     -------------------------
  241.     Additions to 2.6 COM-AND:
  242.     -------------------------
  243.  
  244. o    COM-AND: Added VT100 escape sequences:
  245.          ESC,'D'       ; VT100: Move cursor down a line
  246.          ESC,'E'       ; VT100: Move cursor down a line to col 0
  247.          ESC,'M'       ; VT100: Move cursor up a line
  248. o    Added "BIOS" parameter to run command, to direct communications
  249.     driver to INT 14H (for LAN modem servers); See appendix below
  250. o    Allow Function/Alt'd keys to be used when menu mode window pulled down
  251. o    Enabled FIFO buffering for 16550A UARTs (see below)
  252. o    Added "Does not exist, create?" query to 'f' subcmds of Alt-D/Alt-M/F1
  253. o    Added carrier detect when not connected to calllog: "CARRIER found"
  254. o    If COM-AND creates a .DFT file, and the script INSTALL.CMD is present,
  255.     it is automatically executed after initialization.
  256.  
  257.  
  258. -------------------------------------------------------------------------------
  259. 901016                  COM-AND 2.7                Page  6
  260. -------------------------------------------------------------------------------
  261. Additions and corrections this release:
  262. -------------------------------------------------------------------------------
  263.  
  264.  
  265.     -------------------------------
  266.     Script changes and corrections:
  267.     -------------------------------
  268.  
  269. o    Corrected MDIAL to NOT issue error message if ESCape is used to exit
  270. o    Corrected SET LD code (off by 2 each entry)
  271. o    Corrected SET BAUD 19K (to allow numeric in front)
  272. o    Enabled SET BAUD 19.2 ('.' delimiter override)
  273. o    Corrected justification of intrinsic value in origin buffer (was
  274.     justifying values used in Alt-P, for example)
  275. o    Corrected SET ZMODEM RECOVER and SET SLOW to show on Alt-O and to
  276.     be stored with STORE DEFAULTS
  277. o    Corrected GET, ATGET etc to not return character backspaced over when
  278.     backspace was last key typed.
  279. o    Preserve ON ESCAPE setting across FCALL
  280. o    COMBASE and COMVEC will now take a string as the port parameter.
  281. o    Changed "_PARM" instrinsic so as to NOT left justify 300 baud value.
  282. o    A label caching problem was corrected.    When a label in an FCALLed
  283.     script duplicates a label in a previously seen script, the label was
  284.     not added to the cache.
  285. o    Modified HITKEY to return false if both 1) an ON ESCAPE routine has
  286.     been provided and 2) an ESC is pending.
  287.  
  288.  
  289.     -------------------------------
  290.     Script language additions:
  291.     -------------------------------
  292.  
  293.     DBOX row col row col attr  ; Draw box with double lines
  294.     MANUAL <number>        ; Invoke manual mode window from script
  295.     ...               ; <number is scancode equivalent>
  296.     MDIR <string>           ; Create subdir (drive:path)
  297.     RDIR <string>           ; Remove subdir (drive:path)
  298.  
  299.     ------------------------------------------
  300.     Script language intrinsic functions added:
  301.     ------------------------------------------
  302.  
  303.     _UART               ; Rtns value: -1 -> no UART, 0 -> 8250,
  304.     ...               ; 1/2 ->16550 (no FIFO), 3 ->16550A (FIFO)
  305.     _MOUSE               ; Mouse presence: rtns string: YES/NO
  306.     _RUNTIME           ; Runtime invoc: Rtns string: YES/NO
  307.  
  308.  
  309. -------------------------------------------------------------------------------
  310. 901016                  COM-AND 2.7                Page  7
  311. -------------------------------------------------------------------------------
  312. Updated scripts in CA26-3:
  313. -------------------------------------------------------------------------------
  314.  
  315. REMAP.CMD            ; Allow decimal numerics as well as hex
  316. REMAP.DOC            ; Updated document to amplify discussion
  317.  
  318. STRIPPER.CMD            ; Fixed handling of long line, when the 80 col
  319.                 ; .. break occurs within a blank string: "  "
  320.  
  321. DIALER.CMD            ; Auto-dialer corrections for modems
  322.  
  323. -------------------------------------------------------------------------------
  324. Known bugs in the current release:
  325. -------------------------------------------------------------------------------
  326.  
  327.  
  328. o    KERMIT 12 and 16 bit checksums don't seem to work with Jan van der
  329.     Eyjk's PCKERMIT.  I have not yet found the incompatibilty.
  330.  
  331. o    Reports have been received, but could not be reproduced, of the CPU
  332.     clock losing time.  No instances have been found due to COM-AND.
  333.     Several instances have been tracked to TSR's and special hardware
  334.     (e.g.  ALL-Charge card).
  335.  
  336.     Some reports suggested that the clock speeds up (!) when run in the
  337.     background under DesqView.
  338.  
  339.     At the time of this writing, a loss of ticks in the CPU clock may be
  340.     reproducable when COM-AND is set to 19.2K baud.  It is being investi-
  341.     gated.    It is suspected that this problem may be related to COM-AND's
  342.     interrupt-driven writes during file transfer.
  343.  
  344.     If you experience a clock that 'lags' (loses time) using COM-AND, it
  345.     is suggested that you run COM-AND with the /w switch.  The /w switch
  346.     disables the interrupt driven write feature.  Transfers under DOS
  347.     will be only marginally slower.
  348.  
  349.  
  350. -------------------------------------------------------------------------------
  351. 901016                COM-AND 2.7                Page  8
  352. -------------------------------------------------------------------------------
  353. Related release; PC-VCO:
  354. -------------------------------------------------------------------------------
  355.  
  356.  
  357.     PC-VCO is Visual Conferencing for the IBM PC.  It is completely
  358.     compatible with all three flavors of MacIntosh VCO/VMCO.  It has
  359.     been in use for more than a year by several groups of people.  On
  360.     GEnie, the IBM RT has a regularly scheduled VCO conference every
  361.     Wednesday at 9PM Eastern Standard Time.
  362.  
  363.  
  364.     The concept of VCO is that each conference attendee draws a set of
  365.     16 (or 18) ICONs, and posts them publically.  Other attendees down-
  366.     load the ICONs (called face files), and add them to their own lib-
  367.     rary of faces.    8 (or 9) expressions (happy, sad, etc) are supported.
  368.     When someone speaks in a VCO conference, the appropriate ICON is
  369.     displayed on all PC-VCO screens.  People who've not uploaded face
  370.     files are depicted as Charlie Brown, Don Martin, or OPUS.
  371.  
  372.  
  373.     PC-VCO interfaces to a public domain text-to speech synthesizer.
  374.     The quality is less than might be desired, but its a start!
  375.     PC-VCO now includes its own speech driver for faster processors.
  376.  
  377.  
  378.     PC-VCO has been distributed (its seventh release) as PC-VCO22.ARC.
  379.     PC-VCO may be used on either CGA, EGA or Hercules graphics adapters.
  380.  
  381. -------------------------------------------------------------------------------
  382. Related release; CCHESS:
  383. -------------------------------------------------------------------------------
  384.  
  385.     CCHESS is Conference Chess - two people can play chess over PLINK's
  386.     PARTY, CIS CB, etc.  CCHESS provides a graphics depiction of a chess
  387.     board, and a log of the last few moves.  Game play can be performed
  388.     entirely with a mouse (if you desire - not necessary).    Games may be
  389.     saved, and restored later for continuation.
  390.  
  391.  
  392.     Version 1.2 is a production release - beta testing is complete.
  393.     However,  I am still looking for comments, criticisms and thoughts
  394.     from those interested in on-line interactive gaming.
  395.  
  396.  
  397.     CCHESS has been distributed (its second release) as CCHESS12.ARC.
  398.     Please read the CCHESS.DOC document for a description of CCHESS.
  399.     CCHESS may be used on either CGA, EGA or Hercules graphics adapters.
  400.  
  401.  
  402. -------------------------------------------------------------------------------
  403. 901016                COM-AND 2.7                Page  9
  404. -------------------------------------------------------------------------------
  405. Related release; CBRIDGE:
  406. -------------------------------------------------------------------------------
  407.  
  408.     CBRIDGE is Conference Bridge - four people can play bridge over
  409.     PLINK's PARTY, CIS CB, etc.  CBRIDGE deals cards, displays hands,
  410.     displays (and protects) the bidding, and monitors game play.
  411.     Bidding can be reviewed at any time, as can game play.
  412.  
  413.  
  414.     Version 1.1 has completed its beta trials.  It has found quite
  415.     usable.  It may be 'rough' in spots...  I am looking for comments,
  416.     criticisms and thoughts from those interested in on-line interactive
  417.     gaming.
  418.  
  419.     CBRIDGE has been distributed (its first release) as CBRIDG11.ARC.
  420.     Please read the CBRIDG.DOC document for a description of CBRIDGE.
  421.     CBRIDGE may be used on either MDA, CGA, EGA or Hercules adapters.
  422.  
  423.  
  424. -------------------------------------------------------------------------------
  425. Related release; CCOLOR:
  426. -------------------------------------------------------------------------------
  427.  
  428.     CCOLOR is another accessory for conferencing.  It tracks the conver-
  429.     sation, and assigns different colors to each speaker.  Each speaker's
  430.     text is highlighted and easy to see.  Of course, a color adapter,
  431.     CGA or EGA is required.  It has to be seen to be appreciated!
  432.  
  433.  
  434.     CCOLOR has been distributed (its second release) as CCOLOR11.ARC.
  435.     CCOLOR may be used on either CGA, or EGA adapters.
  436.  
  437.     -------------------------------------------------------------------
  438.     A new release of CCOLOR (1.2) may be expected shortly after COM-AND
  439.     2.7's release, with screen clock and chat mode additions.
  440.     -------------------------------------------------------------------
  441.